Inside Macintosh: QuickTime Components /

Chapter 9 - Movie Data Exchange Components / Movie Data Exchange Components Reference

Exporting Movie Data /

MovieExportToHandle

The MovieExportToHandle function allows the Movie Toolbox to export data from a movie, using your movie data export component.

pascal ComponentResult MovieExportToHandle 
                                 (ComponentInstance ci,
                                  Handle dataH, Movie theMovie,
                                  Track onlyThisTrack,
                                  TimeValue startTime, 
                                  TimeValue duration);

ci

Identifies the Movie Toolbox's connection to your movie data export component.

dataH

Handle to be filled with the converted movie data. Your component must write data into this handle that corresponds to your component's subtype value.

Your component should resize this handle as appropriate.

theMovie

Identifies the movie for this operation. This movie identifier is supplied by the Movie Toolbox. Your component may use this identifier to obtain sample data from the movie or to obtain information about the movie.

onlyThisTrack

Identifies a track that is to be converted. This track identifier is supplied by the Movie Toolbox. If this parameter contains a track identifier, your component must convert only the specified track.

startTime

Specifies the starting point of the track or movie segment to be converted. This time value is expressed in the movie's time coordinate system.

duration

Specifies the duration of the track or movie segment to be converted. This duration value is expressed in the movie's time coordinate system.

DESCRIPTION

The Movie Toolbox calls the MovieExportToHandle function in order to export movie data into a handle. Your component must read the data from the specified movie or track, perform appropriate conversions on that data, and place the data into the handle. The data stored in the handle must have a data type that corresponds to the component subtype of your movie data export component.

If your component can write data to a handle, be sure to set the canMovieExportHandles flag in your component's componentFlags field.

Your component must be prepared to perform this function at any time. You should not expect that any of your component's configuration functions will be called first.

RESULT CODES

invalidTrack

-2009

Specified track cannot be converted

Other appropriate Movie Toolbox result codes

SEE ALSO

The Movie Toolbox uses the MovieExportToFile function to export data to a file; this function is described next.

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help